共用方式為


Manage orders - Gets a product promotion by id.

依標識碼取得促銷詳細數據。

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

URI 參數

名稱 位於 必要 類型 Description
id
path True

string

升級標識碼。

version
path True

string

country
query

string

國家/地區代碼。

要求標頭

名稱 必要 類型 Description
Authorization True

string

授權持有人令牌

ms-correlationid

string

用於在內部追蹤要求。 如果未提供 ms-correlationid,伺服器會為每個要求產生新的要求

MS-CV

string

用於在內部追蹤要求。 如果未提供 MS-CV,伺服器將會為每個要求產生新的要求

ms-requestid

string

用於要求等冪性。 如果未提供 ms-requestid,伺服器將會為每個要求產生新的要求

回應

名稱 類型 Description
200 OK

Contracts.V1.Models.ProductPromotion

要求成功。 回應本文將包含促銷詳細數據。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

輸入遺失或無效。 回應本文會提供錯誤詳細數據。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

要求未通過驗證。 客戶端必須先向合作夥伴 API 服務進行驗證。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

要求已通過驗證,但因為呼叫端沒有叫用要求的許可權而遭到拒絕。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

找不到資源,或無法使用指定的輸入參數。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

合作夥伴 API 服務或其其中一個相依性無法滿足要求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

定義

名稱 Description
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

名稱 類型 Description
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

名稱 類型 Description
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

名稱 類型 Description
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

名稱 類型 Description
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

名稱 類型 Description
billingCycle

string

duration

string